home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
001
/
dsz0921.arc
/
DSZ.DOC
< prev
next >
Wrap
Text File
|
1987-09-21
|
26KB
|
661 lines
DSZ(DOS) Omen Technology DSZ(DOS)
NAME
dsz - ZMODEM, True YMODEM(TM), XMODEM file transfer
subprogram
SYNOPSIS
dsz [CON] [port N] [speed S] [handshake XX] [d] [d] command
DESCRIPTION
Dsz uses the ZMODEM, True YMODEM(TM), or XMODEM protocol to
transfer files over a serial port with a variety of
programs.
ZMODEM Transfers feature 32 bit CRC, crash recovery, and
advanced file management.
True YMODEM(TM) transfers preserve exact file length and
modification time.
Dsz supports XMODEM-1k (XMODEM with 1024 byte blocks,
sometimes mislabeled YMODEM) and CRC-16 with the sx -k and
rc commands.
Dsz is derived from Omen Technology's Professional-YAM
communications software, (also published by POLYTRON Corp of
Hillsboro Oregon as PowerCom(TM)), and supports a subset of
Pro-YAM's file transfer related commands. This
documentation makes extensive references to contemporary
editions of the ZCOMM or Pro-YAM manual, and is incomplete
without it.
Dsz is designed to be called from a communications bulletin
board program. Dsz may also be called from other
communications programs, but the combination lacks much of
the power of a communications program with integrated
ZMODEM.
Dsz uses its own modem I/O. The original interrupt vector,
UART parity, interrupt configuration, and 8259 interrupt
mask are restored on exit.
Dsz uses DOS standard output (stdout) for messages, it does
not write directly to the screen. Dsz expects its standard
output to point to the console, a logging file, or NUL, not
the modem port. If necessary, dsz's standard output may be
redirected to the console device with the CON command. If
dsz's standard output has been redirected to the modem (as
with ProComm's Host mode DOS shell), failure to use the CON
command may lock up the computer.
Dsz exits with 0 status for successful transfers, or the
value of the Q parameter (default 1) if a file transfer
failed. Some languages do not return this information to
Page 1 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
the calling program. A batch file that calls dsz directly
may be used to detect the dsz exit status, or dsz's log file
entries may be examined.
ENVIRONMENT VARIABLES
DSZLOG
log file to receive entries for files sent and
received. (Default null). Sample entries:
Z 46532 38400 bps 3324 cps 0 errors 66 1024 DSZ.COM
Z 124087 19200 bps 1880 cps 0 errors 6 1024 MXY.TMP
Transfer times are based on the DOS time of day clock
and have one second jitter. As with all protocol
throughput reports generated by Omen Technology
programs (and contrary to the false claims of some
critics), dsz's throughput figures for ZMODEM, Kermit,
and True YMODEM(TM) transfers do not take "credit" for
pathname and/or protocol overhead characters. Dsz's
throughput reports do not include the time required to
send the pathname. This understates the true time
required to transfer files, but the time required to
send the pathname often depends on the alacrity of the
operator, and thus does not always reflect the
performance of the protocol itself.
Transfers measuring less than one second are reported
as having 9999 characters per second throughput.
The unlabeled numeric field after the error (retry)
count is the number of flow control stoppages
encountered sending the file. This number gives an
indication of flow control restrictions (overloaded
networks, etc.) encountered during the transfer.
The last numeric field is the block or subpacket length
used for the last block in the file.
The code letter indicates the type of transfer, Z
(ZMODEM), S (X/YMODEM), R (X/YMODEM), E (error), or L
(transfer terminated by loss of data carrier).
DIRSIZE
Memory to allocate for wildcard file name expansion,
default 1495 bytes.
DSZPORT
Default communications port override, default 1.
COMMANDS
Dsz commands are an improper subset of Pro-
YAM/PowerCom/ZCOMM commands. Except as noted, all commands
must be in lower case.
Page 2 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
Unlike ZCOMM, PowerCom, and Pro-YAM, dsz does not support
ZMODEM AutoDownload and ZMODEM command download with ZMODEM
security challenge. (AutoDownload is a pleasant user
interface that recognizes the start of a file download and
automatically starts the correct file transfer protocol.
Please refer to the ZCOMM/PowerCom/Pro-YAM user manual for
details on this powerful and convenient feature.) Dsz does
not support OverThruster(TM), Kermit, Kermit AutoDownload,
Super Kermit, B Protocol, the traditional XMODEM variants
MODEM7, Telink, WXMODEM, and Clink/SEAlink supported by
Pro-YAM/PowerCom/ZCOMM.
Interrupt keys:
Ctrl-Break
Terminates the transfer in progress.
ALT-N
Abruptly terminates (NUKES) the transfer in progress.
When used, the CON, port, speed, handshake, and d commands
must be given in the order shown.
CON Redirect message output to the DOS "CON" (console)
device, overriding any previous redirections.
handshake XX
Enable one of several choices of hardware handshake.
(The default is XOFF/XON software handshake). This
command is documented in the ZCOMM or Pro-YAM manual.
port N
select port N (n = 1,2,3,4 ... 8) Default is port 1
(COM1) or read from the DSZPORT dos environment
variable.
speed S
Set the specified speed. This command is rarely needed
because dsk reads the port's current speed by default.
Please refer to to the FLOW CONTROL, MAIN COMMANDS and
SOFTWARE COEXISTENCE chapters in the ZCOMM or Pro-YAM
manual for important information about the speed
command.
d Disables carrier dropout monitoring, for modems that do
not properly drive the "Data Carrier Detect" input on
the PC.
LARG Convert ARG to lower case, then parse arg.
pxN Set a numeric parameter x to N. These parameters are a
subset of the Pro-YAM or ZCOMM numeric parameters, and
are listed below. They assume their defaults each time
dsz is called. Without an argument, p displays the
numeric parameters and their values.
z pxN
Set zmodem numeric parameter x to N. These parameters
correspond to the Pro-YAM or ZCOMM "zmodem" parameters
Page 3 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
and rarely need changing. These parameters assume
their defaults each time dsz is called. Without an
argument, z p displays the zmodem numeric parameters
and their values.
restrict
Restrict pathnames to the current disk and directory
tree, and disallows overwriting of existing files.
When dsz is restricted, it will refuse to transfer
files containing the string autoexec.bat and
command.com in either case. This provides some defense
from malicious uploaded files.
t Talk with ZMODEM AutoDownload. A small subset of Pro-
YAM term function subcommands are recognized. Keyboard
F1 or ALT-X to exit. F3 receives file(s) with True
YMODEMTm, ALT-P toggles parity between the 8N default
and 8G (enables ANSI "graphics"). ALT-H toggles two
local echo ("Half Duplex") modes; the second displays a
newline on Enter. Keyboarded ASCII characters are sent
to the modem. Modem characters print on the screen. A
device driver such as ANSI.SYS may be used to recognize
escape sequences. ZMODEM AutoDownload detects the
start of a ZMODEM file download and accepts the file(s)
without operator intervention.
sz [-abenprY+y] [PREFIX=p | ONAME=n] file ...(ZMODEM)
sb [-k] [PREFIX=p | ONAME=n] file ... (YMODEM or
ZMODEM)
sx [-k] file1 (XMODEM or XMODEM/CRC)
rz [-abenpr+Yy] [dir] [file ...] (ZMODEM)
rb [-ab+y] [dir] [file ...] (YMODEM)
rb -g
[-ab+y] [dir] [file ...] (YMODEM-G)
rc [-ab+y] file1 (XMODEM/CRC)
rx [-ab+y] file1 (XMODEM)
PARAMETERS
Dsz uses the following main numeric parameters, settable
with the pxN command. In addition, dsz uses the Pro-
YAM/ZCOMM zmodem numeric parameters described in the Pro-
YAM/ZCOMM manual.
B Set the size of buffer used for disk reads and writes.
The default is 1024, 8192 maximum. A larger value may
give better results when sending files to or from from
sluggish floppy disk systems. Too large a value will
exhaust memory or induce receiver timeouts. This
parameter is supported on versions compiled with
TurboC.
Q Error code returned to DOS (default 1). (Success
returns 0.) Some programs toss cookies when confronted
with certain exit codes.
S Timeout in seconds waiting for restraint release (XON
and/or handshake).
Page 4 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
W Wait for Enter key before exiting after an error.
Useful when calling dsz from DESQview, allows the
window to close unless there is an error message that
should remain visible.
a Calibrates certain protocol timeouts used with XMODEM
and YMODEM transfers (Cybernetic Data Recovery(TM)).
The a numeric parameter is automatically set to 2000
for a 4.77 mHz PC or XT, 4000 for a PS2/30, 6000 for an
8 mHz 1ws AT, and 12000 for a PS2/80. If your computer
has a speedup card or otherwise runs unusually fast (or
slow!) for its type, you should set the a numeric
parameter to a value that reflects its speed.
v Verbose level (debugging output) Negative values
inhibit some routine messages
z Timezone in minutes behind GMT
BACKGROUND OPERATION
Three DESQview description files are provided to demonstrate
background operation with modest (66 kb window) memory
requirements. Dsz uses tight C/ASM code, table driven CRC
generators, and buffered receive and transmit for good
performance in the background without hogging CPU cycles.
On a QIC Labs PC-AT clone, dsz can download files in the
background (3 background clock ticks, 9 foreground clock
ticks) with a throughput better than 9600 bps.
2S Prompts for file name(s) and sends them with ZMODEM
protocol.
2T Talks to the modem and allows manual YMODEM (F3) or
automatic ZMODEM downloads.
2A Like 2T, but using Quarterdeck's dvansi.com memory
resident ANSI CRT device driver to process ANSI screen
codes. DS.BAT is the batch file used by 2A.
These files are written for port 2 local connection,
but may be modified to suit your requirements. The W
numeric allows DESQview to close the window after dsz
finishes, providing a pleasant user interface.
Operation at high speed (above 9600 bps) requires the
DESQview "Optimize communications" performance Advanced
Setup option.
***********************************************************
WARNING
When running dsz under a multi tasking system such as
DESQview, do not allow two programs to access the same
comm port at the same time. At best, such actions will
disrupt communications. At worst, your computer will
attempt to open a subspace channel to V'ger.
***********************************************************
Page 5 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
FLOW CONTROL
Please refer to the Pro-YAM, PowerCom, or ZCOMM manual FLOW
CONTROL chapter for important information on flow control
considerations necessary for proper operation of ZMODEM and
other streaming protocols with buffered (error correcting)
modems and/or networks.
EXAMPLES
dsz sz c:foo.* b:*.c (send files)
dsz sz -r yzmodem.arc (CRASH RECOVERY: resume
interrupted transfer)
dsz handshake both sz yzmodem.arc (Hardware+Software
handshake)
dsz sz -n *.* (send files that are newer or
rx has no copy)
dsz sz -Yn *.* (Only send files that are
newer than receiver's copy)
(Do not send files
that do not exist on receiver's disk)
dsz rz C:/UPLOADS (receive files to specified
directory)
dsz port 2 speed 38400 restrict rz
dsz rz -y prog.arc (ZMODEM, single file pathname
override)
dsz z pr1 rx foo.dat (XMODEM receive, remove file
if error)
DSZ LRC L-Y NEWPROG.ARC (generate lower case "rc -y"
command)
dsz pv2 sz foo >debug.dmp (Debugging data dump)
ERROR MESSAGES
Dsz's error messages are a subset of Pro-YAM's error
messages which are listed in the Pro-YAM manual. A
perplexing, cryptic message comes from the Microsoft C
Library: "Permission denied". This may be caused by
attempts to modify a read only file or directory.
A furtive flashing appearance of "XOFF" or "FLOW" during
ZMODEM or YMODEM-g file sending signifies dsz is responding
to flow control restraint. This is normal operation when
buffered modems or packet switched networks are used.
ZMODEM's robustness and reliability allow creative users to
Page 6 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
transfer files over unusual multiple computer lash-ups,
causing modem data lights and computer status displays to
dance in unfamiliar rhythms.
SEE ALSO
Consult the Professional-YAM, PowerCom, or ZCOMM manual
chapter "OPTIONS FOR FILE TRANSFERS" for option meanings.
The "FILE TRANSFER BASICS" chapter explains the relative
merits of XMODEM, YMODEM, ZMODEM, and other protocols and
gives tips on their use. The "MAIN COMMANDS" chapter
describes the rb, rx, rc, rz, sb, and sz commands. The
"MODEM INTERFACING" and "FLOW CONTROL" chapters contain
important information on the use of buffered modems with
dsz.
Information on the ZMODEM Inter Application File Transfer
Protocol may be found in ZMODEM.DOC, part of ZMODEM.ZOO.
C Source code for XMODEM, YMODEM, and ZMODEM transfers is
included in RZSZ.ZOO. This file includes a Pro-YAM/ZCOMM
script to upload a bootstrap file to a Unix system, force
its compilation, and (if the compilation is successful)
upload the rz/sz source files.
NOTES
Some XMODEM programs claiming to support YMODEM do not send
or accept the YMODEM pathname block. 1024 byte XMODEM is
XMODEM-1k, not YMODEM. 1987 versions of YMODEM.DOC clarify
the official YMODEM definition.
When running under ProComm's Host mode, failure to use the
CON command may lock up the computer. ProComm must be set
to "8N1" to prevent it from disrupting DSZ.
When installing dsz on a bulletin board or host system, be
sure to check for proper operation when the caller hangs up
while a file is being sent or recieved.
Currently, Only the TurboC version supports file sharing
(shared read access on files sent by dsz). Some bulletin
board interface routines do not call dsz to send a file
until they have verified the file's existience by opening
the file. If this checking is done in MS-DOS's default
exclusive open mode, dsz's file sharing will be defeated.
32 bit CRC code courtesy Gary S. Brown.
Cybernetic Data Recovery(TM), Error Containment(TM),
OverThruster(TM), Password Guardian(TM), CryptoScript(TM),
and TurboDial(TM) are Omen Technology trademarks.
PowerCom was trademarked in 1985 by POLYTRON Corporation,
Page 7 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
Hillsboro Oregon.
Dsz and this documentation are Copyright 1987 by Omen
Technology Inc, all rights reserved. True YMODEM(TM) is an
Omen Technology Trademark signifying YMODEM protocol support
that meets the full YMODEM specification.
FILES
ZCOMMDOC.ARC, ZCOMMEXE.ARC, ZCOMMHLP.ARC, YZMODEM.ZOO
(yzmodem.arc) (Official XMODEM, YMODEM, and ZMODEM Protocol
Description), RZSZ.ZOO (rzsz.arc) (Unix/Xenix source code),
2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, 2T-PIF.DVP DSZ.COM, DSZ.DOC
(this file).
DSZ.EXE compiled with the Xenix to DOS XC provides
moderately higher maximum throughput (1700 vs 1300 cps
downloading to a 4.77 mHz XT). The speed difference is a
function of the compiler, the source code is the same. The
Xenix XC version requires more memory, and does not support
file sharing or a large I/O buffer. This version is
available in DSZEXE.ZOO.
ZCOMM and Pro-YAM also run at a higher speed than DSZ.COM.
Incompatible batch files may cause dsz to fail.
LICENSE
Dsz is a user supported program developed and supported by
Chuck Forsberg. It has taken considerable resources to
develop and support dsz in the myriad environments users
apply it. If you use this program, please register it.
This documentation file must be provided with all copies of
DSZ except by written permission from Omen Technology Inc.
Dsz may not be modified, patched, hacked, disassembled,
decompiled, or otherwise reverse engineered, or sold,
without prior written permission by Omen Technology Inc.
Distribution of dsz in any medium without this documentation
file constitutes an unauthorized modification.
When dsz is distributed on disk, a contemporary copy of
ZCOMMDOC.ARC must be included on the same disk.
Dsz may be used and copied by bulletin board systems which
feature the ZCOMM files (ZCOMMEXE.ARC, ZCOMMDOC.ARC,
ZCOMMHLP.ARC) for downloading. Dsz registration and a
diskette with current versions of the ZCOMM files will be
mailed upon validation. Dsz may be registered without
charge by sending your bulletin board's telephone number and
a valid login to
Omen Technology Inc.
Page 8 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
P.O. Box 4681
Portland, OR 97231
Other users may register their copy of dsz with a check for
$20.00 in U.S. funds sent to the same address.
Users, especially those overseas, may choose to register
their copy of dsz for $25.00 U.S. by providing their VISA
or Mastercard card number with expiration date and their
name as it appears on their card.
***********************************************************
The registration package includes a serial number and
installation program which bypasses the opening
advertisement.
The registration package will serialize all current and
planned future versions of DSZ.COM and DSZ.EXE.
***********************************************************
The putsnp program inserts YOUR DSZ, ZCOMM, PowerCom, or
Pro-YAM Serial Number Password (SNP) into you copy of DSZ:
putsnp dsz.com
Putsnp accepts your SNP and asks appropriate questions
before inserting the SNP.
The only legitimate way to disable the opening advertisement
in dsz is to insert an authorized SNP obtained from Omen
Technology into dsz with the putsnp program. Any other
suppression or modification of the opening screen is
illegal, unethical, and prohibited.
Distribution of programs and/or instructions on how to
modify, patch, disassemble, decompile, or otherwise reverse
engineer dsz without prior written permission by Omen
Technology Inc is a theft of services and a violation of
federal copyright law, and will be referred to the FBI for
investigation and prosecution under federal conspiricy
statutes. Applicable RICO law provides for treble damages
and recovery of attorney's fees.
CHANGES
Pirated/hacked versions of DSZ have cost users and dsz's
developer thousands of dollars in lost time and other
expenses, in addition to injuring the reputation of Omen
Technology and its products. Regrettably, Omen Technology
cannot support prior versions of dsz because of this piracy.
dsz.com 45600 Squeezed 10% 41409 21 Sep 87
3:26p ca58
Page 9 (printed 9/21/87)
DSZ(DOS) Omen Technology DSZ(DOS)
If your copy of dsz does not show this information (as
provided by arc v dsz.arc), instst on a legitimate copy and
report the source of the pirated copy to Omen Technology
Inc.
Omen Technology Incorporated
The High Reliability Software
17505-V Northwest Sauvie Island Road
Portland Oregon 97231
VOICE: 503-621-3406 :VOICE
Modem: 503-621-3746 Speed 1200,2400,19200 PEP
Compuserve:70007,2304 GEnie:CAF
UUCP: ...!tektronix!reed!omen!caf
Page 10 (printed 9/21/87)